home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin.fmt / dump.man < prev    next >
Encoding:
Text File  |  1991-12-21  |  7.3 KB  |  201 lines
  1.  
  2.  
  3.  
  4. DUMP                      User Commands                      DUMP
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      dump - A program that dumps directories
  12.  
  13. SSYYNNOOPPSSIISS
  14.      dduummpp [_o_p_t_i_o_n_s] _d_i_r_e_c_t_o_r_y
  15.  
  16. OOPPTTIIOONNSS
  17.      --aa             Reset access times after dumping each file.
  18.  
  19.      --ff  _f_i_l_e_n_a_m_e   Use _f_i_l_e_n_a_m_e as the name of the dump archive.
  20.  
  21.      --hheellpp          Print a help message.
  22.  
  23.      --ii nnuummbbeerr      Initialize the tape,  using  nnuummbbeerr  for  the
  24.                     label.
  25.  
  26.      --ll  _d_i_g_i_t      The single digit in the range  0-9  specifies
  27.                     the dump level.  The default is zero.
  28.  
  29.      --mm _u_s_e_r_n_a_m_e    Send mail  to  _u_s_e_r_n_a_m_e  to  report  a  fatal
  30.                     error, or successful completion.
  31.  
  32.      --rr             Re-initialize the tape.  Any data on the tape
  33.                     is lost.
  34.  
  35.      --ss             Safe re-initialization of tape.   The  reini-
  36.                     tialization  will  fail  if the tape has been
  37.                     recently used.
  38.  
  39.      --tt             Print the dump archive table of contents.
  40.  
  41.      --vv             Verbose.  The name of each file is listed  as
  42.                     it is dumped.
  43.  
  44.      --uu             Unofficial dump.  The dump is not recorded in
  45.                     the dumpdates file.
  46.  
  47. _________________________________________________________________
  48.  
  49.  
  50. IINNTTRROODDUUCCTTIIOONN
  51.      The dduummpp command is used to do an incremental dump of a  set
  52.      of  directory.   It will recursively dump all files and sub-
  53.      directories.  Each file that has been  created  or  modified
  54.      since  the  last  lower  level  dump  will  be copied to the
  55.      archive file.  For example, the command
  56.  
  57.           dump -l 2 -f /dev/tape0 /sprite
  58.  
  59.      will dump all files in the directory //sspprriittee in tar  format,
  60.      to //ddeevv//ttaappee00.
  61.  
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  December 20, 1991                  1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. DUMP                      User Commands                      DUMP
  73.  
  74.  
  75.  
  76. TTAAPPEE FFOORRMMAATT
  77.      Dump tapes have a particular  format.  It  is  assumed  that
  78.      blocks  on  the  tape  cannot be overwritten, so the tape is
  79.      written in an append-only fashion.  When a tape is  initial-
  80.      ized  a  file called the tape _l_a_b_e_l is written at the begin-
  81.      ning of the tape. Each time a filesystem  is  dumped  a  new
  82.      updated  tape  label  is  written to the end of the tape, so
  83.      that the current tape label is always the last  one  on  the
  84.      tape. The tape label is 16 Kbytes in size, and consists of a
  85.      sequence of ASCII strings separated by newlines.  The  first
  86.      string is of the form
  87.  
  88.           SPRITE DUMP TAPE, Version _v Level _x Tape _n
  89.  
  90.      where _v is the version of dduummpp that wrote the tape, xx is the
  91.      level  of the dump tape, and nn is the dump tape number.  The
  92.      version is intended to allow future versions of dduummpp  to  be
  93.      backwards  compatible.  The level is filled in when the tape
  94.      is initialized, but is otherwise unused.  It could  be  used
  95.      by  dduummpp  and  higher-level software to automate the dumping
  96.      process.
  97.  
  98.      Subsequent lines in the tape label contain a table  of  con-
  99.      tents for the tape, and are of the form
  100.  
  101.           _T_a_p_e_N_u_m _F_i_l_e_N_u_m _M_B_D_u_m_p_e_d _M_B_L_e_f_t _D_a_t_e _F_i_l_e_S_y_s_t_e_m
  102.  
  103.      where _T_a_p_e_N_u_m is the tape number, _F_i_l_e_N_u_m is the file number
  104.      on  tape  corresponding  to the current entry (starting with
  105.      1), _M_B_D_u_m_p_e_d  is  the  number  of  MBytes  dumped  from  the
  106.      filesystem,  _M_B_L_e_f_t is the number of MBytes remaining on the
  107.      tape after the filesystem was dumped, _D_a_t_e is the date  when
  108.      the filesystem was dumped, and _F_i_l_e_S_y_s_t_e_m is the name of the
  109.      filesystem that was dumped.
  110.  
  111. FFIILLEESS
  112.      //sspprriittee//aaddmmiinn//dduummpp//dduummppddaatteess
  113.           When a dump completes the information that  is  written
  114.           into  the  tape  label  is also written into this file.
  115.           Each line is of the form
  116.  
  117.           _T_a_p_e_N_u_m _F_i_l_e_N_u_m _M_B_D_u_m_p_e_d _M_B_L_e_f_t _D_a_t_e _F_i_l_e_S_y_s_t_e_m
  118.  
  119.           where _T_a_p_e_N_u_m is the tape number, _F_i_l_e_N_u_m is  the  file
  120.           number  on  tape  corresponding  to  the  current entry
  121.           (starting with 1), _M_B_D_u_m_p_e_d is  the  number  of  MBytes
  122.           dumped  from  the  filesystem,  _M_B_L_e_f_t is the number of
  123.           MBytes remaining on the tape after the  filesystem  was
  124.           dumped,  _D_a_t_e  is  the  date  when  the  filesystem was
  125.           dumped, and _F_i_l_e_S_y_s_t_e_m is the name  of  the  filesystem
  126.           that was dumped.
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  December 20, 1991                  2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. DUMP                      User Commands                      DUMP
  139.  
  140.  
  141.  
  142.      //sspprriittee//aaddmmiinn//dduummpp//dduummpplloogg
  143.           This file contains low-level debugging information that
  144.           is printed out by dduummpp as it runs.
  145.  
  146.      //sspprriittee//aaddmmiinn//dduummpp//ssttaattuusslloogg
  147.           This file contains information about the status of both
  148.           the  tape drives and the tapes.  A line is added to the
  149.           file each time a dump completes, and is of the form
  150.  
  151.           _D_r_i_v_e_T_y_p_e _S_e_r_i_a_l _T_a_p_e_N_u_m _M_B_D_u_m_p_e_d _E_r_r_o_r_R_a_t_e _D_a_t_e _D_e_v_i_c_e
  152.  
  153.           _D_r_i_v_e_T_y_p_e is the type of  drive  that  was  used  (e.g.
  154.           EXB-8500).   _S_e_r_i_a_l  is the serial number of the drive.
  155.           The combination of the drive  type  and  serial  number
  156.           should  allow  tape  drives  to be uniquely identified.
  157.           _T_a_p_e_N_u_m_b_e_r is the number of the  tape  that  was  used.
  158.           _M_B_D_u_m_p_e_d  is  the  number  of  MBytes that were dumped.
  159.           _E_r_r_o_r_R_a_t_e is the number  of  errors  per  tape  access,
  160.           expressed  as  a percentage of tape accesses.  An error
  161.           rate of 100% means that there was  an  average  of  one
  162.           error  per  tape access.  The definition of an error is
  163.           vendor specific but an increase in the error rate  over
  164.           time  may indicate that a tape is wearing out or that a
  165.           drive needs servicing.  The _D_a_t_e is the date  on  which
  166.           the  dump  occurred,  and the _D_e_v_i_c_e is the name of the
  167.           device as passed  to  the  dduummpp  command.   The  latter
  168.           should  not  be  considered to uniquely identify a tape
  169.           drive since the mapping between the device name and the
  170.           device  can  change,  thus  the  drive  type and serial
  171.           number should be used to look for an  increasing  error
  172.           rate on a particular drive.
  173.  
  174. KKEEYYWWOORRDDSS
  175.      dump, restore, tape, backup, tar
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0       Printed:  December 20, 1991                  3
  198.  
  199.  
  200.  
  201.